sound_pool object

This method will update the position of a sound on a 1d grid.

bool update_sound_1d(int slot, int x)

Parameters:
slot
The slot of the sound to update.
x
The new position of the sound.

Return value:
true on success, false on failure.

Remarks:
This method will update the position of individual sounds. To update all the sounds based on the listener's position, use the update_listener methods instead.

Please note: When dealing with sound slots, be sure that you set the persistent flag to true for all non-looping sounds when you first create them. If you fail to do this, manipulating a sound in any way by use of its slot number can have unpredictable results. This is because the sound pool automatically cleans up any sound that has finished playing and that is not set to be persistent, with the result that the slot that was returned on creation is no longer invalid and may, in the worst case scenario, refer to a completely different sound.

Example:
#include "sound_pool.bgt"

sound_pool sounds;
timer move_timer;

int pos;

void main()
{
sounds.max_distance=70;
pos=0;
int slot=sounds.play_1d("sounds/loop.wav", 50, pos, true);
while(true)
{
if(move_timer.elapsed>=200)
{
move_timer.restart();
pos++;
sounds.update_sound_1d(slot, pos);
}
if(pos>=100)
{
exit();
}
}
}